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INTRODUCTION 

SYNASSEMBLER is a convenient and powerful tool for software 
development on the Atari computer system. The assembler uses 
standard 6562 mnemonics and syntax, and includes many useful 
features for creating, editing, assembling and testing your 
assembly language programs. Now assembly language 
programming is almost as easy as programming in BASIC. 

Here is a summary of the most exciting features: 

31 Full use of the standard Atari Screen Editor 

51 Tab stops for opcode, operand, and comment fields 

31 Fast parametrized renumber and delete command 

51 Uses BASIC like commands for files (eg.LQAD, SAVE, BLOAD etc.) 

51 Labels up to 32 characters long (lowercase letters and . accepted) 

31 English ERROR messages 

31 Ability to append source programs from tape or disk 

51 Oi splay of memory usage 

31 Multiple source files, using .IN directive 

51 Store object code directly to disk file, using the .TF directive 

51 Listing to screen option using .LI ON and .LI OFF 

31 Assembles 6588 lines/minute 

51 Local labels 

31 Offending line is listed after an ERROR occurs 
31 Value of .EQ and address of .BS are printed on listing 
31 ASSEMBLER, DOS, HARDWARE, and OS locations protected during assembly 
31 ATASCII literals in address expressions 
31 Symbol table printed in alphabetical order 


Synassembler requires 48K of RAM and one • disk, drive to 
operate. Very large programs can now be developed, using the 
"INCLUDE" and "TARGET FILE" capabilities. These allow the 
assembly of multiple source files, and direct storage of object 
code on binary files. 



We have included several sample programs to illustrate the use 
of the SYANASSEMBLER as well as being useful routines. These 
include: 

1. HARSH SCROLL :A utility to coarse scroll the Atari screen 

display 

2. FINE SCROLL .:A utility to fine scroll the Atari screen 

display 

3. PM MGUER ....:A utility to move players and missies on the 

on the screen. 

BELL :Ring the bell using Atari sound 

generators. 


Blanks are compressed in source files to conserve memory and 
save space on disks. The compression algorithm replaces any 
string of consecutive blanks with a single code byte. Also, Atari 
assembler files are compatable and only require minor 
modification to assemble correctly. (See APPENDIX for further- 
detail). Synassembler uses a memory-efficient method of storing 
the symbol table, with variable length entries. The symbol table 
is maintained in alphabetical order, using a high speed hashing 
scheme. The symbol table is maintained in memory until a new 
assembly is started or the NEW command is typed. This allows 
the RUN and VAL- commands to be more useful and effective. 
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Assembler error messages are printed on the Screen and 
accompanied by a pleasant bell like tone on the speaker, (At 
least as pleasant as an ERROR message can be). After an 
assembly error is detected the offending line is listed to the 
screen automatically, in a position for easy editing. 
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COMMANDS 

There are three types of commands in the SYNASSEMBLER: 
EDITING commands, DOS commands and MONITOR commands. 
The EDITING commands are used to control the Editor and the 
assembler. Commands are typed immediately after the prompt 
symbol, which looks like this COk.3. 


EDITING COMMANDS 

There are seventeen editing commands in the SYNASSEMBLER. 
All editing commands may be abbreviated to the first three 
letter s if you so desire. 


ASM Assemble source program, put object program 

into memory, and produce assembly listing. 

CQPy Duplicates specified lines 

in the source. 

DELete Delete specified line. 

FINd List all lines containing the 

specified string. 

HIDe Changes the HIMEM pointer to 

‘hide 11 current source code 
prior to a MERge command. 

INCrement Set the line K increment for 

automatic line numbering 


LISt 


List the source program or 
specified lines of source code. 



MEMory Display the beginning and ending address 

MERge Use with HIDe to join source programs 

MOUe Moves a line of source code from one 

specified location to another 

NEW Delete the entire source program 

RENumber Renumber all or specified lines of 

source code 

RERlace Replace a specified string with another 

specified string 

REStore Restores HIMEM pointer after HIDe and 

MERge. 

RUN Begins execution of your object program 

UAL Evaluates an operand expression and prints 

the value in hexidecimal 

MQN Exit the editor and enter the monitor 



- 6 - 


EDITING COMMAND DETAIL 

The SYNASSEMBLER editor combines the powerful Atari screen 
editing -features with a BASIC-like line editor. Source programs 
are entered and edited in almost exactly the same way you would 
enter and edit an Atari BASIC program. 

ASM command: 

SYNASSEMBLER is a two pass assembler. The ASM command 
initiates assembly of your source program. During the first pass 
it builds a symbol table with the definition of every label that is 
used in your program. During the second pass the assembler 
stores the object code into memory or disk and produces an 
assembly listing. At the end of the second pass a list, in 
alphabetical order, of all the labels and their- definitions is 
produced. 

If any errors are detected during either pass, an error- message 
will be printed as well as the offending line. The error message 
will briefly explain the type of error encountered and the line 
will be positioned for easy editing. All of these messages abort 
the assembly process, so that as soon as you correct the error- 
condition you may immediately restart the assembly. 

If you are listing the assembly to the screen you may use the 
[CTRL3+C13 control to start and stop your listing. You may 
abort the assembly process by hitting the [BREAK! key in pass 
two of the SYNASSEMBLER. 
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COPy Li L2 


This command places a copv of line L2 just before LI in ihe 
source. The new line is assigned line number LI. The old line L2 
remains in the source. This command should if there are multiple 
lines with the same line number in the source. 


COPy Li L2 L3 


This command places a copy of lines L2 through L3 just before 
line Li in the source. The old lines are assigned line number Li. 
The old line L2 through L3 remain in the source. This command 
should be followed by a renumber command if there are any 
multiple lines with the same line number in the source. 


DELete command: 

Deletes a line or a range of lines from your- source program. 
Another way to delete a single line is to type it's line #, 
followed immediately by a carriage return. 

HIDE AND MERGE 


These two commands) when used with the LOAD command allow 
you to join a program from disk, or tape to a program that is 
already in memory. 


HIDE temporarily changes the HIMEM pointer so that it appears 
as if there were no source program in memory. To remind you that 
you are HIDE-ing, the prompt symbol changes to CH] ok. After 
HIDE-ing a program) you can load another one from disk or tape. 
Then you type MERGE to join the two programs together. 



After- this sequence of commands* the program which was already 
in memory will follow after the program just L-OADed. If the line 
numbers are not already as you wish them to be* you can use the 
RENUMBER command to assign new ones. 


For example, suppose that we have 2 source programs on the disk 
named "PARTI" and "PART2". We want to join them together so 
that "PARTI" precedes "PART2". 


OK. 


LOAD *D:PART1 

1 

Ok. 


LIST 


06818 X 

PROGRAM NUMBER ONE 

00020 MAIN 

JSR SUBROUTINE 

00030 

RTS 

OK. 


LOAD * D : PART 2 

it 

Ok. 


LIST 


00010 X 

PROGRAM NUMBER TWO 

00020 SUBROUTINE 

00030 

LDA BOAT. LOG 

00040 

ASL 

00050 

ASL 

00060 

RTS 

Ok. 


HIDE 


IH1 Ok. 


LOAD "D:PART1 

H 

IH1 Ok. 


LIST 


00010 X 

PROGRAM NUMBER ONE 

00020 HAIN 

JSR SUBROUTINE 

00030 

RTS 

[HI Ok. 


MERGE 


Ok. 
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INCrement 


Sets the increment used -for automatic line number generation. 
The increment is normally 10, but you may set it to any value 
between 0 and 9999. 


INC 5 


FINd 


The FIND command allows you to search through your source 
program tor a given text string, and list all the lines that 
contain that string. The correct procedure tor use of this 
command is as -follows: Type FIND, followed by a space, and then 
the string for which you are searching. Every character you type 
between the space and the carriage return is part of the search 
key. (NOTE: you may append or prefix spaces to any string to 
perform label searches.) 


LISt Li L2 

Lists a single line, a range of lines or your entire program. It 
works just like the list command in BASIC. While a program or 
range of lines is listing you can use the standard Atari pause 
control ECTRL13, to start and stop the listing to the screen. 
You may abort the listing by pressing the [BREAK! key. 
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MEMory 

Displays the beginning and ending memory address of the source 
program and of the symbol table. 

Source program: $9B99-9C1F 
Source length: $8886 
Symbol table: $1F88-1F88 


Memory between the top of the symbol table and the bottom of 
the source program is free to be used without clobbering 
anything. 


MERge 


SEE "HIDe and MERge" 


MOVe Li L2 


This command places a copy of line L2 just before Li in the 
source. The new line is assigned line number Li. The old line L2 
is removed from the source. This command should be followed by 
a renumber command if there are multiple lines with the same 
line number in the source. 

MOVe Li L2 L3 


This command places a copy of lines L2 through L3 just before 
line Li in the source. The new lines are assigned line number Li. 
The old lines L2 through L3 are removed from the source. This 
command should be followed by a renumber command if there are 
multiple lines with the same line number in the source. 
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RUN 

Begins execution of your object program. An expression MUST 
•follow the RUN command to define the place to begin execution 
of the program. For example, "RUN BEGIN" will cause execution 
to begin at the point in your program where the label BEGIN is 
defined. Your program will return to SYNASSEMBLER by using 
an RTS instruction in your program. You may abort your program 
by hitting the [RESET 3 key. Or, you may use the CBREAK3 key to 
break and fall back to the monitor. 

NEW 


This command acts just like it's BASIC counterpart. It deletes 
the current source program from memory and re-starts 
SYNASSEMBLER just as though you were to re-boot the program. 


NOTE: A source program must, of course, be assembled into 
memory before it can be executed with the RUN command. 

RENumber 


Renumbers all or part of the lines in your source program with 
the specified starting line number and increment. There are three 
optional parameters for specyfying the line number to assign the 
first renumbered line (base), the increment, and the place in your 
program to begin renumbering (start). There are four possible 
forms of the command: 


REN 

Renumber the whole source program: 
BASE=1880, INC= 18 , START=8 

REN « 

Renumber the whole source program: 
BASE=8 , INC=10, START=8 

REN #1,82 

Renumber the whole source prooram: 
BASE=81, INC=82, START=0 

REN 81,82,83 

Renumber all lines from 83 through 
the end. 

BASE=8 1 , INC=82, START=83 
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The last -form above is useful for opening up a "hole" in the line 
numbers for entering a new section of code. 


OK. 

LIST 

00008 * A RENUMBER EXAMPLE 

00003 START 

LOA 1180 

00013 

STA $95 

00058 

LDA 198 

00103 

STA *A0 

00110 

RTS 

OK. 

REN 

OK. 

LIST 

00010 * A RENUMBER EXAMPLE 

08020 START 

LDA 0188 

00030 

STA *95 

00040 

LDA *90 

00050 

STA *A0 

00060 

RTS 

OK. 

REN 100 

OK. 

LIST 

00100 * A RENUMBER EXAMPLE 

00110 START 

LDA *180 

08120 

STA *95 

00130 

LDA *90 

00140 

STA *A0 

00150 

RTS 

OK. 
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REN 2800,4 

OK. 

LIST 


02000 i A RENUMBER EXAMPLE 

02004 START 

LDA 0100 

02008 

STA $95 

02012 

LDA 090 

02016 

STA $A8 

02020 

RTS 

OK. 


REN 3008,10,2088 

OK. 


LIST 


02008 X A RENUMBER EXAMPLE 

02084 START 

LDA 0108 

03808 

STA $95 

83810 

LDA 090 

03028 

STA $A0 

03830 

RTS 


REPlace dSldS2d 

This command replaces all occurences of string SI with string S2 
in the source, d is a delimiter and must be a non-space printable 
character that does not appear in either Si or- S2. 
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REPlace dSldS2d,P 

This command causes a search to be made for string Si. The 
search starts at the beginning of the source. Whenever SI is 
found, the line containing it is listed and the user is prompted 
for 1 of 3 actions: 


Y or [RETlUNl-replace SI with 
S2 and continue. 

N-do not replace SI with S2 
and continue search. 

X-do not replace SI with S2 
and stop search. 

d is a del ini ter and must be 
a non-space, printable character 
not appearing in either SI 
or S2. 


REStore 


Restores the root source program if an assembly is aborted while 
inside an "included" module. 


The "root source program" is the source program that is in 
memory at the time the "ASH" command is issued. If this source 
program uses the ".IN" directive to include additional source 
files, it is possible that assembly might be aborted either 
manually by typing a [BREAK] key during the listing phase, or 
automatically due to an error in the source program. 
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If the assembly is aborted during the time that the root program 
is hidden, the prompt character changes -from "Ok" to "Cl] Ok". 
The RESTORE command will reset the memory pointers so that 
the root program is no longer hiden, and change the prompt 
character back to "Ok". 


You do not have to use the REStore command after an abort 
unless you wish to get back to the root source program ■for- 
editing purposes. If you type the ASM command, the assembler 
automatically restores before starting the assembly. 


If an assembly aborts due to an error in a source line, you may 
correct the source line, SAVE the module on the appropriate file* 
and type ASM to restart the assembly. 

VALue 


The VAL command will evaluate any legal operand expression, 
and print the value in hexadecimal. It may be used to quickly 
convert decimal numbers to hexidecimal, to determine the ASCII 
code for a character, or to find the value of a label from the last 
assembled program. 

EXAMPLE: 


VAL ' T 

$8854 88884 

OK. 

VAL 3493 + $3493 
$4238 16952 

OK. 

VAL START ♦ S12 
$4288 16896 

OK. 
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DOS commands: 


LOAd and SAVe 

These commands are used to store your source -files onto Disk or 
Tape in the internal compressed -form. This saves disk space and 
speed. 

EXAMPLE: LOAd ■DiGAMEl.TXT" or SAVe "DiMISC.SRC 


BLOAd and BSAVe commands: 

These commands are used to load and save BINARY -files to disk. 

NOTE: BLOAd and BSAVe -function in the same manner as the L 

and K options in Atari DOS II. 

EXAMPLE: BLOad "D:GAME.GBJ\ 

(This will load the binary file called 
GAME. OBJ into memory at the address where 
where it was saved.) 

BLOad *D:GAME.OBJ",$2808 

(this will load GAME.OBJ starting 
at HEX 2088, not at the address where 
it was saved.) 

EXAMPLE: BSAve "D:GAME. OBJ, $2000, $4000 

(This saves a binary file called GAME.OBJ 
from Hex location $2088 to $4008. 

NOTE; the $ always must precede a hexidecimal number. 

SYNASSEMBLER assumes a decimal number if the $ sign is not 
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ENTer 

This command allows you to enter ASCII text directly -from tape 
or disk. It functions like the ENTER command in Atari BASIC. 
You can use this command to ENTER Atari assembler source files 
and then convert them to SYNASSEMBLER format. 

EXAMPLE: ENTer , D:ATARIFIL.SRC* or ENTer"C:\ 


TYPe 

The TYPE command is used to save your source to any device in 
full ASCII format. 

EXAMPLE: TYPe , D:MYSOURCE.TXT’ 

(This command saves the full ASCII source under 
the MYSOURCE.TXT file, to disk drive 1) 

TYPe *P:* ... sends the source file to the printer. 


BIRectory 

The directory command is used to examine the contents of your 
diskettes. 

EXAMPLE: DIR by itself will show you the catalog for disk drive 1 

DIR "DiK.OBJ* will show anything in the catalog on drive 1 with 
an OBJ extender. 

DIR ‘D2:K.TXT' 1 will show anything in the catalog on drive 2 with 
an OBJ extender. 



The DOS command jumps -from SYNASSEMBLER into the resident 
DOS in your system. 


OUTput 

The OUTput command is used to redirect the output of 
SYNASSEMBLER to another devicejeg. printer, disk»screen etc. 

EXAMPLE: OUT H P:" 


After changing the output you may use the ASM command to send 
assembled listings to the device specified. To cancel the 
re-direction simply type OUTput without a filespec. 


EXAMPLE: OUTput. 
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ZYNAPSE MONITOR 


The ZYNAPSE monitor in SYNASSEMBLER allows you to 
examine, change, move, and verify memory. You may read and write 
to disk, and cassette, dis-assemble machine-language programs; 
execute programs; perform hexidecimal arithmetic; read and write 
sectors directly to and from disk; and monitor program execution 
for debugging purposes. 


MONITOR COMMANDS 

DISPLAY MEMORY: adrsi.adrs2 [RETURN] 

This command allows you to display the memory from addressl to 
address 2. 

EXAMPLE: 2908.4000 and [RETURN] 


CHANGE MEMORY: adrsjdata data 

In order to change data at a particular address enter the addr ess 
(in HEX of course), and then a semi-colon!;) after which you may 
enter as musch data as you wish making sure that each byte is 
seperated by exactly one space. 


EXAMPLE: 2880 ;4C 88 90 
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After having entered and address* you may just use a semi-colon 
to indicate the next location -for your next data entry. 

EXAMPLE: 2088 ;4C 
588 
;90 


This example has the same effect as the previous example. 
DIS-ASSEMBLING MEMORY: adrsL 

This command allows you to dis-assemble 20 instructions 
starting at the specified address. By typing L L again the next 
20 instructions will be dis-assembled. 


ADDITION AND SUBTRACTION (HEX): data+data or data-data 

You may add or subtract data (in HEX) simply by entering data 
and pressing [RETURN]. 


MOVING MEMORY : adrsl<adrs2.adrs3M 

You may easily move data from one part memory to another. You 
first specify the address into which you wish to move* and then 
the range of memory that is to be moved. 

EXAMPLE: 2800<3FF0.4088M 


VERIFY MEMORY: adrsl<adrs2.adrs3V 

If you wish to compare two blocks of memory, you can easily do 
so by specifying the starting address of the block you wish to 
compare and then the range that you wish it compared to. 


EXAMPLE: 2880<3FF0. 4080V 
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DISK (READ and WRITE): adrs<secl.sec2r (READ) 
adrs<secl.sec2w (WRITE) 


This unique feature of the ZYNAPSE monitor allows you to 
access the disk directly. The first parameter is the starting 
address of the buffer in which you wish to store the contents of 
the seel through sec2. Note:The READ and WRITE commands are 
lowercase. (CAUTION: BE EXTREMELY CAREFUL WHEN 
ACCESSING THE DISK DIRECTLY. YOU CAN EASILY 
OVERWRITE THE CONTENTS OF YOUR DISK.) 

EXAMPLE! 2888<1.4r (reads sector 1 through 4 into 
buffer starting at 2888) 

2888<1.4w (writes the contents of buffer 
starting at 2888 to sectors 1 
through 4.) 


RESTORING NORMAL MODE: N 


This command tells the assembler to restore the original screen 
color and tab stops to the power-up specifications. 

OTHER COMMANDS 


These commands are mainly used for execution and debugging 
assembly language programs. 

EXECUTE 


The G command is used to execute a program from the monitor, by 
typing the program address and the G command. 

C*3 Ok 
4000G 


This will execute a program at 4000. 
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A-fter having entered and address* you may just use a semi-colon 
to indicate the next location -for your next data entry. 

EXAMPLE: 2089 ;4C 
;08 
;9D 


This example has the same effect as the previous example. 
D1S-ASSEMBLING MEMORY: adrsL 

This command allows you to dis-assemble 20 instructions 
starting at the specified address. By typing L L again the next 
20 instr uctions will be dis-assembled. 


ADDITION AND SUBTRACTION (HEX): data+data or data-data 

You may add or subtract data (in HEX) simply by entering data 
and pressing [RETURN]. 


MOVING MEMORY: adrsl<adrs2.adrs3M 

You may easily move data from one part memory to another. You 
first specify the address into which you wish to move, and then 
the range of memory that is to be moved. 

EXAMPLE: 2088<3FF0.4088M 


VERIFY MEMORY: adrsl<adrs2.adrs3V 

If you wish to compare two blocks of memory* you can easily do 
so by specifying the starting address of the block you wish to 
compare and then the range that you wish it compared to. 


EXAMPLE: 2808C3FF0. 4800V 
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DISK (READ and WRITE): adrs<secl.sec2r (READ) 
adrs<sed.sec2w (WRITE) 


This unique feature of the 2YNAPSE monitor allows you to 
access the disk, directly. The first parameter is the starting 
address of the buffer in which you wish to store the contents of 
the seci through sec2. Note:The READ and WRITE commands are 
lowercase. (CAUTION: BE EXTREMELY CAREFUL WHEN 
ACCESSING THE DISK DIRECTLY. YOU CAN EASILY 
OVERWRITE THE CONTENTS OF YOUR DISK.) 

EXAMPLE: 2888<1.4r (reads sector 1 through 4 into 
buffer starting at 2888) 

2888<1.4w (writes the contents of buffer 
starting at 2888 to sectors 1 
through 4.) 


RESTORING NORMAL MODE: N 


This command tells the assembler to restore the or iginal screen 
color and tab stops to the power-up specifications. 

OTHER COMMANDS 


These commands are mainly used for execution and debugging 
assembly language programs. 

EXECUTE 


The G command is used to execute a program from the monitor) by 
typing the program address and the G command. 

[*3 Ok 
4000G 


This will execute a program at 4000. 
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EXAMINE and MODIFY registers 

The R command allows you to examine and modify the 6562 
registers (A»X,Y,P,S>. 

[*3 Ok 
R 

A=05 X = i6 Y=56 P=30 S=F7 


They can now be modified with the command 


STEP and TRACE (see also DEBUGGING) 

The S and T commands are for single stepping your assembly 
language program but the T repeats the S command indefinitely. 
The S command will execute one instruction: 

m OK 
48085 

4808: A? 0- LDA »83 
A=03 X=88 Y=80 P=?0 S=F8 


At this point you may modify the register. 

The T command will do the same thing as the S command except it 
will just repeat it forever. To get out of this mode, just tap the 
CBREAK3 key. 

QUIT 

The Q command will return you to the assembler. 
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SOURCE PROGRAM FORMAT 


Source programs are entered a line at a time, with a five digit 
line number identifying each line. The line numbers may run from 
00006 through 63999. Source program line numbers are kept 
sorted in line-number order; the numbers are used for editing 
purposes, just as in BASIC. A blank must always follow the line 
number. After the blank, there are four fields of information: the 
label, opcode, operand, and comment fields. Adjacent fields must 
be separated by at least one blank. 


Although the fields are not restricted to begin in any particular 
columns, it is convenient to enter them in in this way for 
neatness. Therefore tab stops are built in to the 
SYNASSEMBLER at columns 9, 13, and 21. 

LABEL FIELD: 


May be left blank, or may contain a label of from one to 32 
characters. The first character of a label must be a letter; 
remaining characters may be either letters or numbers. Labels 
are used to name places in your program to which you will branch, 
as well as constants and variables. 


The standard tab settings leave enough room for only 9 character 
labels; however, you can go ahead and use 32 characters as long 
as there is at least one space between the label and the opcode. 
If you like, you may type labels on a separate line, with the 
opcode and the following fields left blank. The label will be 
defined as the current value of the location counter. There are 
some examples of this in various listings throughout the manual, 
and in the example source code on the disk. 
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OPCODE FIELD: 

Contains a three-letter- machine language mnemonic opcode* or 
assembler directive. However, opcodes may begin in any column 
a-fter at least one blank -from a label or two blanks -from a line 
number. 

OPERAND FIELD: 

Usually contains an operand expression of some sort. Some of 
the 6502 instructions have no written operand, such as NOP, 
BRK, DEX, and others. In these cases the comment field may be 
started right after the opcode. Four of the opcodes (RDL, ROR, 
ASL, and LSR) may be used both with and without an operand. If 
no operand is present, you must type at least TWO blanks before 
a comment with these four opcodes. 


COMMENT FIELD: 

Comments are separated from the operand field by at least one 
blank. Actually, comments may begin earlier or later on the line, 
just so at least one blank separates them from the operand 
expression. 


COMMENT LINES: 

Full lines of comments may be entered by typing an asterisk (*) 
or a semi-colon (;) in the first column of the label field. This 
type of comment is useful in separating various routines from 
each other, and labeling their contents. It is analogous to the 
REM statement in BASIC. 



DIRECTIVES 


Twelve assembler directives are available through 
SYNASSEMBLER. 

.AS (stores ASCII literals.) 

.AT (stores ATASCII literals) 

.BS Cexpression] . (RESERVE [expression] bytes at the current 

.DA [expression] enter data 

.EN ENd of source i optional) 

.EQ [expression] (EQuate labels) 

.HS (define Hex data) 

.LI OFF (Turn off the assembly listing.) 

.LI ON (Turn on the assembly listing.) 

•IN [filename] .(Include a source program the specified file. 

.OR [expression] Indicates the originating address of your 
assembled code. 

.TA expression (Target Address) 

.TF [filename] — Put the object program on the specified file. 
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ASCII STRING: .AS daaa...ad 

The .AS directive stores the binary -form of the asc ii characters 
"aaa...a" in sequential locations beginning at the current 
location. If a label is present) it is defined as the address 
where the first character is stored. The string" aaa...a" may 
contain any number of printing ASCII characters. You indicate 
the beginning and end of the string t by using any delimiter ("d" in 
the example)) that you choose. 

ASCII character codes are seven bit values. The .AS directive 
normally sets the high order bit (8th)> to zero. Some people like 
to use ascii codes with the high order byte set to one, so 
SYNASSEMBLER includes an option for this. 

.AS daaa....d sets the high order bits = 0 
.AS -daaa...d sets the high order bits = 1 

This syntax restricts the choice of the delimiter slightly) in that 
the delimiter can be any printing character other than a space or 
a minus sign. Since the Atari inverse characters are set with the 
high order bits to zerot you merely put the minus sign before the 
string and you will get the characters in inverse mode. 

ATASCII STRING: .AT daaa...ad 

This is the same as AS except that output is in ATARI ASCII. 
BLOCK STORAGE: .BS exp 

Reserves a block of <exp> bytes at the current location in the 
program. The expression specifies the number of bytes to 
advance the location counter. If there is a label) it assigned the 
value at the beginning of the block. 

The address of the beginning of the block will be printed in the - 
address column of the assembly listing. If the object code is 
being stored directly into memory) no bytes are stored for the 
.BS directive. However, if the object code is being written on a 
file using the .TF directive, the .BS directive will write <exp> 
bytes on the file. All the bytes written will have the value of 
$ 00 . 
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DATA label .DA expression (two bytes, LSB -first) 

.DA ^expression (one byte, LSB of expression) 

.DA /expression (one byte, MSB of expression) 


Creates a constant or variable in your program. The value of the 
expression, as one or two bytes, is stored at the current 
location. If a label is present, it is defined as the address 
where the first byte of data is stored. 


4889: 

4083: 

4006 : 

4008: 

4809: 

400A: 


4000: 

4089: 

400A: 

4008: 


0A 08 64 
00 E8 03 


10 27 

00020 DEC.NUH 

.DA 10,100,1088,10000 

64 

00030 VALUE 

.DA 0100 

FB 

00040 m2 

.DA 0-5 

FF 

00050 m3 

.DA 0*FF 

— 

Symbol table 



DEC.NUH 

MAL2 

m3 

VALUE 


END OF PROGRAM .EN 

This defines the end of the source program. You would normally 
make this the last line, but you may place it earlier in order to 
assemble only a portion of the source program. If no .EN is 
present anywhere in your program, the assembler will assume 
you meant to put this the last line. 
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EQUATE : label .EQ <expression> 

Defines the label to have the value of the expression. If the 
expression is not defined* an error message is printed 
(UNDEFINED LABEL)* and the offending line is listed out. If 
you neglect to use a label with an equate directive* an error 
message (UNDEFINED LABEL)* is printed. In either case, the 
assembly is aborted so that you can correct the error. All page 
zero references must be made before they are used or all labels 
defined after that reference will be off by i. 


EXAMPLE 


6888 

8881: 

8882 

80E6: 


88020 

.OR 

00030 NUH1 

.BS 

00048 NUM2 

.BS 

80050 TABLE 1 

.BS 

08060 ADR 

.BS 

00070 

.OR 

80080 * main 

program l 


(88 

1 

1 

1 

100 

$4080 


— Symbol table — 
88E6: ADR 
0088: NUM1 
0881: NUM2 
8882: TABLE 1 


HEX STRING: label MS hhh...h 


Converts a string of hex digits (hhh...h) to binary* two digits per 
byte, and stores them starting at the current location. If a label 
is present* it is defined as the address where the first byte is 
stored. If you do not have an even number of hexadecimal digits, 
the assembler aborts with an error message, (BAD ADDRESS), 
and lists the offending line. NOTE: Unlike hexidecimal numbers 
used in the operand expressions, you must NOT use a dollar sign 
with the JiS directive. 
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LISTING CONTROL .LI OFF and .LI ON 

This pair of directives ‘turns -the assembly listing on and off. If 
.LI OFF is put at the beginning of the source program, and no .LI 
ON is used, no listing at all will be produced. The program will 
assemble much faster without a listing, as most of the time is 
consumed putting the characters on the screen, and scrolling the 
screen up. 

If you put .LI OFF at the beginning of your source program, and 
•LI ON at the end, only the alphabetized symbol table will print. 

You may also use this pair of directives to bracket any portion 
of the listing you may wish to see or not see. 


INCLUDE: - .IN [file name] 

Causes the contents of the specified source file to be included in 
the assembly. 

The program which is in the memory at the time the ASM command 
is typed is called the “root" program. Only the root program may 
have .IN directives in it. If you attempt to put .IN directives in 
an included program, the "NESTED INCLUDE FILE" error will 
print. 

When the .IN directive is processed, the root program is 
temporarily "hidden" and the included program is loaded. 
Assembly then continues through the included program. When the 
end of the included program is reached, it is deleted from memory 
arid the root program is restored. Assembly then continues with 
the next line of the root ptogram. 
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The .IN directive is useful in assembling extremely large 
programs which cannot fit in memory all at once. It is also useful 
for connecting a library of subroutines with a main program. 


The [filename] portion of the directive is in standard FILESPEC 
format. 


08828 * START OF PROGRAM 

08038 

.OR $5088 

00048 

.IN '0:PART 1" 

88050 

.IN *D :PART2" 

00860 

.IN *D:PART3* 

00070 

.EN 


ORIGIN: .OR <expression> 

This sets the program origin and the target address to the value 
of the expression. Program origin is the address at which the 
object program will be executed. Target address is the address 
is the memory address at which the object program will be stor ed 
during the assembly. The .OR directive sets both of these 
addresses to the same value, which is the normal way of 
operating. If you do not use the .OR directive the assembler will 
set both the program origin and the target address to 14000. If 
the <expression> is not defined durin SYNASSEMBLERS pass 1 
pr ior to it's use in the .OR directive, an error message is printed 
and assembly is aborted. The error message that appears is 
“UNDEFINED LABEL" and the offending line is listed for easy 
editing. 
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TARGET ADDRESS: .TA <expression> 

Sets the target address at which the object code will be stored 
during assembly. The target address is distinct from the 
program origin (which is either set by the .OR directive or 
default at $4000). The .OR directive directive as we have seen, 
sets both the origin and target address. The .TA directive 
allows the added control of setting ontly the target address. 
Object code is produced and ready to run at the program origin) 
but is stored starting at the target address. 

TARGET FILE: .TF C filename 3 

Causes the object code generated to be stored on a binary file 
rather than in memory. Only the code which follows the .TF 
directive will be stored on the file. Code will be stored on the 
file until aother .TF directive is encountered, or until a .TA or 
.OR directive is encountered. The [filename 3 format is the 
standard ATARI filespec format. 
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When you wish to assemble a program which will execute at an 
address normally occuppied by the assembler ($9C00 through 
$C000) or a already resident source program* you need to use the 
.TA and the .OR directives. Set the origin first, using the .OR 
directive and then set the target address to a safe value using 
the .TA directive. It is always safe to start the target area at 
$4000. 




00010 X SAMPLE PROGRAM TO 



00026 If THE 

.TA DIRECTIVE 



00030 

.OR $1006 



00640 

.TA $4000 

1006: AO 0C 

10 

08650 NUN 

LDA TEMP. A 

1003: AE 00 10 

06066 

LDX TEMP.X 

1066: AC 0E 

10 

00070 

LDY TEMP.Y 

1069: 4C 00 

10 

00080 

JMP MAIN 

100C: 32 


00090 TEMP .A 

.DA #50 

1000: 64 


60106 TEMP.X 

.DA #180 

100E: 22 


00116 TEMP.Y 

.DA #34 

— Symbol 

table — 



1660: MAIN 
100C: TEMP. A 
1060: TEMP.X 
100E: TEMP.Y 


As you can see in the example, the assembly language listing 
looks as though the program was stored at $1000. However, the 
object code is actually stored at $4000, which is the target 
address set in the .TA directive. If we disassemble memory 
starting at $4000, we see: 
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Ok 

MON 

Zynapse monitor 
[if] Ok 
4880L 


4008: 

AO 

0C 

10 

LDA 

I188C 

4803: 

AE 

0D 

10 

LDX 

$100D 

4886: 

AC 

0E 

10 

LDY 

*180E 

4809: 

4C 

08 

10 

JMP 

$1000 

400C: 

32 



??? 


408D: 

64 



??? 


488E: 

22 



??? 


408F: 

00 



BRK 


4018: 

00 



BRK 


4811: 

00 



BRK 


4812: 

00 



BRK 



After the assembly is complete, there are several ways to 
position the code in memory where it really should be. You can 
save the object code on cassette or disk from its current 
location, and reload it at the correct location for execution. Be 
sure not to reload it while executing the assembler, or you may 
clobber it. 

Another method is to enter the monitor and use the monitor move 
command (addrl addr2.addr-3M ). This command will move the 
block of memory from addr-2 through addr-3 to the area beginning 
at addrl. 

LABELS: 

There are two types of labels used in SYNASSEMBLER: normal 
labels and local labels. 
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NORMAL LABELS: 

The -first character of a normal label must be a letter; 
subsequent characters may letters, digits, or the period 
character The period is useful for making long labels 

readable. For example, the subroutine used to read the next 
source line might be named "re ad .next. source. line". 

Tab stops are set up within the editor assuming that most of 
your labels will be 9 characters or less. However, since the 
assembler is relatively free-format, you may type any length 
label followed by a blank and the opcode, operand, and comment 
fields. Or, if you wish, you may type the long label on a line all 
by itself. In this form the label is assigned the current value of 
the location counter, just as if you had appended ”.EQ *" to the 
line. 

01888 * StfIPLE PROGRAM WITH LONG LABELS 
81818 SOURCE. LINE. POINTER .EQ $13 AND $14 
81028 CHAR. POINTER .EQ $12 
01038 * 

81848 READ .NEXT. CHAR. FROM. LINE 
81058 LDY CHAR. POINTER 

01868 LDA (SOURCE.LINE, POINTER) ,Y 

01078 INC SOURCE.LINE. POINTER 

01088 RTS 

LOCAL LABELS: 

SYNASSEMBLER introduces a new kind of label called "local 
labels", the main purpose for the local labels is to make 
programs more readable by reducing the number of label names 
you must invent. As a side effect, local labels save considerabl 
space in the symbol table during assembly; they only reqir-e two 
bytes each. The use of local labels also encourages structured 
programming habits. 
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Local labels have a period as the first character, followed by one 
or- two digits. Any label from .0 through .99 may be used. 

The local label must be within a page of the normal label or an 
error will result. 

Since each set of local labels is associated with a particular 
normal label, you may re-use the same local label 


Here is an example of three little routines in the same source 
program using normal and local labels: 

81800 PRINT .1CSSAGE 

01810 PHA SAME A-REGISTER 

81028.1 JSR PRINT. CHARACTER 

01030 IKY 

01840 IDA MESSAGES ,Y 

81058 BNE .1 =8 FOR END OF MESSAGE 

81048 PLA RESTORES A-REGISTER 

01870 RTS 

01088 I 

81098 GET .NEXT. CHARACTER 
01180 LDY CHAR. POINTER 

01110 LOA INPUT. BUFFER ,Y 

01128 CMP 0RETURN 

81138 BEQ .1 EM) OF LINE 

01148 INC CHAR. POINTER 

01158 .1 RTS 

01148 I 

81170 GET. NEXT .NQNBLANK. CHAR 

01188.1 JSR GET .NEXT. CHARACTER 

81190 BEQ .2 END OF LINE 

01288 CMP IBLANK 

81218 BEQ .1 

81228 .2 RTS 
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MEMORY USAGE 


The SYNASSEMBLER program is about 8000 bytes long, and 
occupies $9C00 through $BC1F in memory. The screen begins at 
$BCiF and goes thr ough tBFFF, while the source progr am begins 
at the top of DOS and goes to I9C00. 


During source program entry or editing, memory usage is 
monitored so that the source program does not grow so large as 
to overlap the symbol table. Overlapping will cause the 
"MEMORY FULL" error message to print. During assembly, 
memory required by the symbol table is monitored, to prevent the 
symbol table from overlapping the source program. Overlapping 
will generate the “MEMORY FULL" error message and abort the 
assembly. 

In addition, memory usage by the object program is monitored, so 
that it will not destroy the source program, DOS, the Operating 
System, and hardware. Therefore, if the object program bytes are 
directed at any memory protected addresses, the "MEMORY 
PROTECT" error message will be printed and assembly. 


OPERAND EXPRESSIONS 


Operand expressions are written using terms and operators. The 
valid operators are + and Terms may be decimal numbers, 
hexidecimal, labels, or an asterisk (*). The first term in an 
expression may be preceded by a + or a - sign. 
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DECIMAL NUMBERS 

Any number in the range from 0 through 65535, written in the 
normal way. 

HEXIDECIMAL NUMBERS: 

Any number in the range from $0 through IFFFF. Hexidecimal 
numbers are indicated by a preceding dollar sign <$), and may 
have from one to four digits. Beware of leaving out the dollar 
sign; the assembler may be quite satisfied to think of your 
hexidecimal number as a decimal one if you omit the ($). In some 
cases even a number with letters in it, such as 23AB, may be 
acceptable; it may be interpreted as decimal 23 and a comment 
"AB". 


BINARY NUMBERS 

Any number in the range from 00000000 to iililili. Binary 
numbers are indicated by the preceding percent (%) sign. 

NUMBERS EXAMPLE: 


Ok. 

4880: 

FI 

00810 * A DECIMAL NUMBER 

00028 NUM1 .DA 

4881: 

E3 

00038 X A HEX NUMBER 

00048 NUM2 .DA #$E3 

4802: 

D6 

08650 X A BINARY NUMBER 

00068 NUM3 .DA 0X11010110 

_ 

— Symbol 

80070 .EN 

table — 

4008: 

NUM1 


4081: 

NUM2 


4883: 

NUM3 


LABELS: 



One to nine characters; the first character must be a letter, 
while the others may be either letters or digits. Labels must be 



defined somewhere in the program if they are to be used in an 
expression. In some cases they must be defined prior- to use in 
expressions to prevent an undefined or ambiguous location 
counter. For example* if the expression in the operand field of an 
origin (".OR") directive is not defined prior to use, the assembler 
will not know how to define any subsequent labels. 

A problem can occur if you postpone the definition of page-zero 
variables until after thier use in operand expressions. If these 
labels are used with instructions which could assume both 
absolute and 2 ero-page address modes, a discrepancy in the 
location count will occur between pass 1 and pass 2, of the 
assembler . This discrepancy cannot be detected by the present 
design of the assembler, so make it a habit to always define your 
page-zero variables at the beginning of your program. 

ASTERISK C*3: 

Stands for the current value of the location counter. This is 
useful for storing the length of a string as a constant in a 
program. 


888A- 8B 

1878 GT 

.DA 8QTS2 

* BYTES IN MSG 

888B- 41 4E 59 




888E- 28 4D 45 




8811- 53 53 41 




8814- 4? 45 

1888 

.AS /ANY MESSAGE/ 


1898 QTSZ 

.EQ *-QT-l 

« BYTES IN MSG 

8816- 88 88 

1188 VARH 

.DA 8 

2-BYTE VARIABLE 

8818- 88 

1118 VARB 

.DA #8 

1-BYTE VARIABLE 


1128 HERE .EG * 

It is considered VERY POOR programming practice to include 
branch instructions in your program with operand expressions in 
the form "*-5" or "#+7". If you value your sanity and time, avoid 
them like the plague! They breed bugs that can be very difficult 
to find. Dont't be afraid to use another label or two, no matter 
how silly the names might sound. 
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ADDRESSING MODES 


The MOS Technology 6502 microprocessor used in the ATARI has 
many great features; one of the greatest is its variety of 
addressing modes. There are thirteen different modes in all, 
though no single opcode can use every one of them. The chart in 
the appendix shows which modes can be used with each opcode. 
But first, here is a chart showing an example of each mode and 


way it is written in 

assembly language. 

MODE 

EXAMPLE 

Implied 

DEX at least two 

Accumulator 

ROL blanks before 

Relative 

BNE expr comments begin 

Immediate 

LDA Kexpr 


LDA /expr 

Zero Page 

LDA expr 

Absolute 

LDA expr Assembler uses 

Zero Page,X 

LDA expr,X Zero Page form 

Absolute, X 

LDA expr.X if possible; 

Zero Page,Y 

LDA expr,Y if not, it uses 

Absolute, Y 

LDA expr,Y Absolute form. 

(Zero Page,X) 

LDA (expr,X) 

(Zero Page) ,Y 

LDA (expr) ,Y 

(Absolute) 

JMP (expr) 


For a full explanation of the modes and how to use them, I refer 
you to the MOS Tecnology Hardware and Programming Manuals, 
as well as the other references mentioned in the bibliography in 
Appendix D. 
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SYNASSEMBLER has one syntactical addition. The immediate 
mode may be indicated by either a pound sign <#) or a slash (/). 
The means that the least significant byte of the 16-bit 
expression value should be used. 

The "I" means that the most significant byte should be used. 

One use for this feature is in setting up the address of a 
subroutine or a buffer in a pointer. (A painter is a pair of bytes 
containing an address which “points" at a subroutine or into a 
buffer.) For example'- 


0088: 


00018 ADR 

.EQ $88 

4008: 

A9 8D 

00028 START 

LDA itSOUND 

4882: 

85 30 

80838 

STA ADR 

4004: 

A9 40 

60040 

LDfVSOUHD 

4886: 

85 85 

00856 

STA ADR* 1 

4088: 

A0 00 

08060 

LDY 40 

408A: 

B1 88 

80878 

LDA (ADR) ,Y 

408C: 

00 

80888 

BRK 

488D: 

10 28 58 

08098 SOUND 

.HS 182850 

4010: 

20 40 98 

00188 

.HS 204898 


— Symbol table — 

8630: ADR 
400D: SOUND 
4600: START 
4000: SOUND 

Trying to comprehend and remember thirteen different 
addressing modes can be very difficult; therefore it is 
convenient to try to group them into categories. You may wish to 
consider the following breakdown: implied mode, relative mode, 
and other- modes. "Other" modes now includes eleven modes, so. 
you can break it down further-, accumulator, immediate, direct, 
and indirect. Each of direct and indirect modes can be either- 
indexed or not indexed, and either Zero page or Absolute. The 
following outline will give you a better- idea of what has been 
described: 
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I. Implied 

II. Accumulator 

III. Direct 

A. Not Indexed 

1. Zero Page 

2. Absolute 

B. Indexed by X-register 

1. Zero Page,X 

2. Absolute, X 

C. Indexed by Y-register 

1. Zero Page,Y 

2. Absolute,Y 

IV. Indirect 

A. Not Indexed - (Absolute) 

B. Indexed by X-register 
(Zero Page, X) 

C. Indexed by Y-register 
(Zero Page) ,Y 

IMPLIED MODE 

In this mode, the address is implied by the nature of the 
instruction; the operand -field is left blank.. All of the opcodes in 
this class are only byte long. They are: 


BRK 

OEX 

PHA 

RTS 

TAY 

CLC 

DEY 

PHP 

SEC 

TSX 

CLD 

INX 

PLA 

SED 

TXA 

CL I 

1NY 

PLP 

SEI 

TXS 

CIV 

NOP 

RTI 

TAX 

TYA 
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RELATIVE MODE 

This mode is used only by the conditional branch instructions. 
The expression is converted to a signed offset -from the location 
following the branch instruction. The result must be in the range 
from -128 through +127 to be legal. All of these instructions 
occupy two bytes. They are: 

BCC/BGE* BEQ BNE BUG 

BCS/BLT* BHI BPL BUS 

S you may use either form for greater than/less than branches. 


OTHER MODES 

Usage of the other eleven modes is much more complex. The table 
in the appendix shows which modes are defined for each of the 
remaining opcodes. These instructions occupy one byte in the 
accumulator mode, two bytes in any zero page modes, and three 
bytes in any of the absolute modes. They are: 


ADC 

AND 

ASL 

BIT 

CMP 

CPX 

CPY 

DEC 

EOR 

INC 

LDA 

LDX 

LDY 

LSR 

ORA 

ROL 

ROR 

SBC 

STA 

STY 

STX 

JMP 

JSR 




You might notice especially that only four opcodes are usable in 
the accumulator mode (ASL, LSR, ROL, ROR); that only two 
opcodes use the "ZP,Y" mode (LDX and STX); and that only one 
opcode uses the indirect absolute non-indexed mode (JMP). 
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EDITING FEATURES 

Any time the cursor is at the beginning of a line* typing [TAB 3 
will cause the next line number to be generated. Immediately 
after loading* the "next line number" will be 10. The number will 
be displayed as five digits abd a trailing blank. The cursor will 
be in a position for the first character of a label* or the asterisk 
for a comment line, or a semi-colon. 


The "next line number" is always the value of the previously 
entered line number plus the current "increment". The increment 
is normally 10, but you can set it to any reasonable value with 
the INCREMENT command. 


If you type the [TAB 3 in any other position than the beginning of 
a line, it will cause a "tab" to the next tab stop. 

TAB STOPS 

The standard tab stops have been changed to allow for a nine 
character label before the opcode. Of course, you may use any 
length label from 1 to 32 characters, followed by a blank and an 
opcode; but the use of the tab stops make for nicer looking 
programs. (Longer labels look nicer if left on a line by 
themselves.) 

CURSOR CONTROL 

SYNASSMBLER allows continued use of the ATARI cursor 
controls by pressing the [CTRL! key plus one of the four arrow 
keys on the right side of the keyboard. In addition, 
SynAssembler makes full use of the ATARI screen 
editor. 
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DEBUGGING PROGRAMS 


Each step ("S"> command decodes* displays, and executes one 
instruction at a time, and the trace (“T") command quickly steps 
through a program, stopping when a BRK instruction is executed. 


Each step command causes the monitor to execute the instruction 
in memory pointed to by the program pointer. The instruction is 
displayed in its disassembled -form, then executed. The contents 
o-f the 6502 's internal registers are displayed a-fter the 
instruction is executed. Then the program counter is bumped up 
to point to the next instruction in the program. 


Here's what happens when you list and then step through a 
sample program: 


Ok. 

HON 


Zynapse monitor 


IK) Ok. 


4800L 


4008: ft? 05 

LDA «$85 

4902: 8A 

ASL 

4083: 8A 

ASL 

4804: 3D 80 20 

STA $2800 

4087: 08 

BRK 

4803: 08 

BRK 


4815: 

80 

BRK 

4816: 

88 

BRK 


m Ok. 



STEP EXAMPLE: 
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[*3 Ok. 

4000S 

4000: A? 05 LDA #$05 

A=05 X=00 Y =00 P=30 S=FD 
[*3 OK. 

S 

4002: 0A ASL 

A=0A X=00 Y=00 P=30 S=FD 

[«3 OK. 

200 

0200: 90 

1*1 OK. 

S 

4003: 0A ASL 

A=14 X=00 Y=00 P=30 S=FD 

[*3 OK. 

S 

4004: 8D 00 20 STA 

A=14 X=00 Y =00 P=30 S=FD 
C*3 OK. 

2000 

2000: 14 

[*3 OK. 

S 

4007: 00 BRK 

4007: A=14 X=00 Y =00 P=30 S=FD 

[#3 OK. 
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TRACE EXAMPLE: 

Ok. 

MON 

Z'/napse monitor 
t*3 Ok. 

4600T 

4000: A 9 05 LDA #405 

A =05 X =00 Y =00 P=30 S=FD 

4002: 0A ASL 

A=0A X=00 Y=00 P=30 S=FD 

4003: 0A ASL 

A=i4 X=00 Y=00 P=30 S=FD 

4004: 8D 00 20 STA #$2000 

A= 14 X =00 Y =00 P=30 S-FD 

4007: 00 BRK 

4007: A=14 X=00 Y =00 P=30 S=FD 

[*] Ok. 


EXAMINING AND CHANGING REGISTERS 


The EXAMINE command is invoked by pressing "R" which tells 
the monitor to display the contents o-f the -five 6502 registers on 
the screen. To change these values* type the semi-colon and the 
new values: 

[*] Ok. 

R 

A=0A X=FF Y =D8 P=B0 S=F8 
*;B0 02 
R 

A=B0 X=02 Y =D8 P=B0 S=F8 
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MONITOR TRICKS 


There are few tricks that you can use in the ZYNAPSE monitor. 
These will generally make your- life easier and programming less 
of a chore. 

All monitor commands may be put on a single line if you separate 
the commands with a space. 

EXAMPLE: D81F D01F D81F 

This will display memory location B81F 3 times. 


Some commands are only one letter long, so you needn't separate 
them with a space. 

EXAMPLE: 2000LLLL 

This will disassemble 88 instructions 

Sometimes you may need to utilize certain commands repeatedly. 
You can do this by typing the command many times, or type it 
once and tell the monitor to repeat it for you. 

EXAMPLE: N 2FC AD;8N 

This will display location 2FC until 
[BREAK! or [SYSTEM RESET! is pressed. 
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SYNASSEMBLER Memory Map 
(assumes 48K memory) 

8800-88EF : Q.S. and Assembler zero page usage. 

88F8-88FF : Free space 

0108-0 IFF : 6582 hardware stack 

0208-02FF : Operating System vector table 

0308-83FF : IOCB vector table 

8488-847F : DOS usage area 

0480-84FF : Assembler usage 

0588-85FF : Assembler input butter 

8600-86FF : Free space (it REPlace not used) 

0708- 1D00 : DOS II 

1D00-9BFF : Free space tor source, symbol table, 
and object code 

9C88-BC1F : SYNASSEMBLER 

BC28-BFFF : Screen display list and data 



APPENDIX III 


CONVERTING ATARI ASSEMBLER FILES 

In order- to convert your- ATARI Assembler/Editor- -files to 
S'/nAssembler -format -follow these simple instructions: 

.Read the ATARI editor/ assembler- files into the SynAssembler 
using the ENTer command. 

.Save the file back to the disk using the SAVe command. This will 
store youe file in compacted format. 

.Make the following changes to your source code: 

i. Remove all references to "A". For example* in the instruction 
LSR A* the "A" should be removed* since SynAssembler- assumes 
the “A" reference. 


2. SynAssembler has no multiply or divide* so these must be put 
in by long hand. 


3. To get the Hi and Lo bytes* make the following changes: 


Atari Assembler 

LDA #PLACE/256 high byte 

LDA #PLACE&255 lo byte 

SynAssembler 

LDA /PLACE high byte 

LDA #FLACE lo byte 


4. All of the Atari directives must be changed to the 
SynAssembler equivalents. 


Now that you have your file in SynAssembler format* you may use 
the local labels and long 32 character labels. 



APPENDIX IV 


BIBLIOGRAPHY 


Publishers have begun -to release some good technical resource 
books tor learning to program the 6502 microprocessor. 


The ATARI Assembler, Eton Inman & Kurt Inman.RESTON 
Publishing Company, 1981. Designed -for the beginner to 
intermediate, this book has 270 pages including many 
illustrations, diagrams and examples. 

6502 Software Eiesign, Leo J. Scanlon. One of the Blacksburg 
Continuing Education Series, published by Howard W. Sams 8 
Co., 1980. 270 pages, paper, $10.50. 

6502 Assembly Language Programming, Lance A. Leventhal. 
Osborne /McGr-aw Hill, Inc., 1979, over 80 programming examples. 

Programming and Interfacing the 6502, with Experiments, Marvin 
L. I)e Jong. One of the Blacksburg Continuing Education Series, 
published by Howard W. Sams & Co., 1980. 414 pages, paperback. 

6502 Software Gourmet Guide and Cookbook, Robert Findley. 
Scelbi Publications, 1979. 204 pages, paperback. Includes listings 
of conversion routines, search and sort routines, and floating 
point routines. 

6502 Games, Rodney Zaks, SYBEX. The third in the SYBEX series 
on programming the 6502. Includes listings of games in assembly 
language. 

Practical Microcomputer Programming: the 6502, W.J. Weller, 
Northern Technology Books, 1980. 459 pages, includes a listing 
of a 6502 assembler and a debugging package. 



APPENDIX V 


ACCUM- IMMED- DIRECT INDIRECT 

ULATOR IATE INDEXED INDEXED 



bl ank 

lexpr 

/expr 

expr 

2P/ABS 


expr,Y 

2P/ABS 

(expr) 

(expr,X) 

(expr) ,Y 

ADC 

— 

69 

65/6D 

75/7D 

— /79 

— 

61 

71 

AND 

— 

29 

25/2D 

35/3D 

— /39 

— 

21 

31 

ASL 

BA 

— 

B6/BE 

16/ IE 

-/- 

— 

— 

— 

BIT 

— 

— 

24/2C 

--/-- 

~/~ 

__ 

~ 

— 

CMP 

— 

C9 

C5/CD 

D5/DD 

— /D9 

— 

Cl 

D1 

CPX 

— 

EB 

E4/EC 


~/~ 

— 

— 

— 

CPY 

— 

ce 

C4/CC 


--/- 

— 

— 

— 

DEC 

— 

— 

C6/CE 

D6/DE 


-- 

— 

— 

EOR 

— 

49 

45/4D 

55/5D 

— /59 

— 

41 

51 

INC 

— 

-- 

E6/EE 

F6/FE 

-/— 

— 

— 

— 

IDA 

— 

A9 

A5/AD 

B5/BD 

~/B9 

— 

A1 

Bl 

LDX 

— 

A2 

A6/AE 

--/-- 

B6/BE 

— 

— 

— 

LDY 

— 

A8 

A4/AC 

B4/8C 

-/- 

— 

— 

— 

LSR 

4A 

— 

46/4E 

56/5E 

— /-- 

— 

— 

— 

ORA 

— 

69 

B5/BD 

15/ ID 

1 

1 

— 

Bl 

11 

rol 

2A 

— 

26/2E 

36/3E 

~/~ 

— 

— 

— 

ROR 

6A 

-- 

66/61 

76/7E 

--/-- 

— 

— 

— 

SBC 

— 

E9 

E5/ED 

F5/FD 

~/F9 

— 

El 

FI 

STA 

~ 

— 

85/8D 

95/90 

— /99 

— 

81 

91 

STX 

— 

_ 

86/8E 


96/— 

-- 

— 

— 

STY 

— 

— 

84/8C 

94/- 

-/- 

— 

— 

— 

JNP 

— 

— 

— /4C 


-/- 

6C 

— 

— 

JSR 

— 

-- 

~/20 

-/- 

-/- 

— 

— 

— 








Warranty 


SYNAPSE SOFTWARE warrants to the original consumer/purchaser that this 
SYNAPSE SOFTWARE program cassette/diskefte (not including the computer 
programs) shall be free from any defects in material or workmanship for a period of 
90 days from the date of purchase. If a defect is discovered during this 90 day 
warranty period, and you have timely validated this warranty, SYNAPSE 
SOFTWARE will repair or replace the cassette/diskette at SYNAPSE SOFTWARE'S 
option, provided the cassette/diskette and proof of purchase is delivered or mailed, 
postage prepaid, to SYNAPSE SOFTWARE. 

This warranty shall not apply if the cassette/diskette ( 1 ) has been misused or shows 
signs of excessive wear, (2) has been damaged by playback equipment, or (3) if the 
purchaser causes or permits the Cassette to be serviced or modified by anyone 
other than SYNAPSE SOFTWARE. Any applicable implied warranties, including 
warranties of merchantability and fitness, are hereby limited to 90 days from the 
date of purchase. Consequential or incidental damages resulting from a breach of 
any applicable express or implied warranties are hereby excluded. 


Notice 


All SYNAPSE SOFTWARE computer programs are distributed on an "as is” basis 
without warranty of any kind. The entire risk as to the quality and performance of 
such programs is with the purchaser. Should the programs prove defective follow- 
ing their purchase, the purchaser and not the manufacturer, distributor, or retailer 
assumes the entire cost of all necessary servicing or repair. 

SYNAPSE SOFTWARE shall have no liability or responsibility to a purchaser, 
customer, or any other person or entity with respect to any liability, loss or damage 
caused or alleged to be caused directly or indirectly by computer programs sold 
through SYNAPSE SOFTWARE. This includes but is not limited to any interruption of 
service, loss of business or anticipatory profits or consequential damages resulting 
from the use or operation of such computer programs. 

The provisions of the foregoing warranty are subject to the laws of the state in which 
the Cassette is purchased. Such laws may broaden the warranty protection avail- 
able to the purchaser of the Cassette. 



SYNASSEMBLER 


Whether- you are an experienced assembly language programmer 
or a novice* the SYNASSEMBLER offers more features and ease 
of use than any other package. SYNASSEMBLER's incredible 
speed and convenient editor makes it an ideal tool for all 
development work on the ATARI computer. Here are just a few 
of the features-- 

* Multiple source files 

* Object code can be stored directly to disk/cassette file 

* Dis-assembles to screen/printer 

* Reserve a block of storage 

* Labels up to 32 characters (9 char acter TAB) 

* Labels may include lower case and periods 
*■ Local labels 

* 50 to 100+ times faster than Atari's ASM/EIH6500 lines/min) 

» “English" error- messages 

* Full Atari editing features 

* Easy conversion for existing Atari Editor-/ Assembler files 

* Complete monitor-/ debugger 

* Automatic line numbering/renumbering 

* Listing on/off option when assembling 

* OS* HARDWARE, DOS, and ASSEMBLER protected during assembly 

* Append source programs from disk or tape 

* Many, many other convenient features 


SYNASSEMBLER is without a doubt the easiest to use, most 
powerful ASSEMBLER/EDITOR for the ATARI system. Learn and 
use the best! 

REQUIREMENTS: 

Atari 800 or 400 computer 
48K memory 
Disk Drive 


Price: $49.95 Disk Special order ROM version $89.95 

SYNASSEMBLER is a trademark of SYNAPSE SOFTWARE 
ATARI is a trademark of Atari, Inc. 



